Succubus Heart
- Created By : Michael P Stanich (AKA Spirit Shard)
- michaelpstanich.com

Help Document
- Last updated : v4.30

Welcome to the official Help Document for Succubus Heart! This document tries to explain the mod's mechanics and features for players to easier understand how everything works. This document will also include option source comments in [] brackets, which can be helpful to people who wish to change Succubus Heart or want to use Succubus Heart as an example.

Table of Contents
- Vocabulary
- The Basics
- - - Drain and it's Effects
- - - Sex/Death Drops
- - - The Succubus Realm
- - - Earning and Spending HeartXP
- - - Earning and Spending HeartSP
- - - BDSM Rating and Passives
- - - Upgrading Perks
- Optional Mechanics
- - - Crafting
- - - Soul Pets
- - - Combat Seduction
- - - Death Override Mode (Rogue-L Mode)
- Advanced Mechanics
- - - Desire
- - - Tracking

<> Vocabulary <>
PC : Short for Player Character
SuH : Short of Succubus Heart. [All scripts and spells will have a SuH_ prefix]
HeartXP : Heart Experience. Used to increase Heart Skills.
XP : Shortened form of Heart Experience.
HeartSP : Heart Skill Points. Used to increase Skill Levels.
SP : Shortened form of Heart Skill Points.
Status : Health/Magicka/Stamina are all considered Status.
Drain/Absorb : The decrease or increase of status.
Life Force/Force : Absorption past Max Status

<>- - The Basics - -<>

<> Drain and it's Effects <>
With Succubus Heart the PC will drain Max Status from NPCs which will then be absorbed. This is called absorption and is permanent in most cases. Drain can also kill NPCs if enabled and provides some alternatives to combat. This can be disabled in the Status / Settings MCM in various different ways, even entirely. (Just keep in mind the mod was designed with this mechanic active)

<> Sex/Death Drops <>
Upon Orgasm all characters will provide their partners with either Sperm or Breast Milk depending on their gender, and if the act is with the PC there is a chance of a rare drop being rewarded to the PC with special effects. Upon death NPCs will also have Soul items added to their inventory. The PC can collect these 'Drops' and use them to upgrade their stats and gain additional HeartXP/SP (or just waste them in alchemy, your choice).

<> The Succubus Realm <>
The Succubus Realm is a small location that can be access and departed by using the 'Succubus Realm -Connect-' Spell. This location offers several useful crafting stations, NPCs that offer items for sale, and more. Upon leaving with the spell you can return your PC either directly back or in another location presented in the menu. This location can act as almost a home-base of sorts, or completely ignored, up to you.

<> Earning and Spending Heart XP <>
HeartXP is earned by the PC through Sex Acts and special interactions with other Succubus Heart mechanics. Once obtained, HeartXP can be spent on various Heart Skills to level different aspects of the PC's Succubus Abilities such as increasing drain amounts or expanding Max Health.

<> Earning and Spending HeartSP <>
HeartSP is earned when the PC drains more than their Max Status Cap (increase with HeartXP). For every point over the cap absorbed the PC earns 1 Force which once enough have been earned they will converted into HeartSP. HeartSP is used to level Skyrim's normal skills such as Light Armor. As SP is earned the Force required for more increases.

<> BDSM Rating and Passives <>
Passives are a way to augment your PC with special abilities that activate automatically. These abilities are enabled and upgraded by using the PC's BDSM Rating. BDSM Rating is increased by increasing Heart Levels, Spending HeartXP to directly increase it, or by upgrading Perks. Passives can have multiple paths to upgrade however chosing any path will increase the cost for other paths at the same rate, however if you're ever unhappy with your choices Passives can be reset at any time and BDSM Rating will be restored to its full value.

<> Upgrading Perks <>
Perks are small objectives that are completed automatically as you play. By doing certain actions perks will level up and give a reward at each rank-up some rewarding bonus HeartXP and others even rewarding BDSM Rating.

<>- - Optional Mechanics - -<>

<> Crafting <>

Crafting Points will be earned through absorption, these points can then be spent on summoning usefull items. As more crafting points are used the player character's crafting level will increase which will decrease the cost of crafting new items by a small amount. (Items have a minimum cost value based on their base values)

<> Soul Pets <>
Soul Pets allows the PC to summon a variety of allied creatures to fight (and act) alongside. When engaging in Sex Acts or taking combat hits pets will gain XP and level up, which in-turn will increase their status and increase their effect strengths. As pets level up so will the PC's Summoner Level, upon reaching new ranks new pets will be unlocked and Pet Effects will increase. Pet Effects can also be set which will take effect in Sex Acts with Soul Pets, such as draining stamina or even healing partners.

<> Combat Seduction <>
This is a simple Combat Submit style mod built right into Succubus Heart, if you're using any other Combat Submit style mod please ensure this feature is disabled to prevent conflicts. In-combat if a character drops below the set Status they will then submit to their attacker and instantly begin an animation. [This feature was originally build for testing however has obviously been slightly expanded and actually works]

<> Death Override Mode <>
Death Override Mode is a Succubus Heart adapted Rogue-Light Mod. When enabled instead of the player dying when their health reaches zero they will instead return to the Succubus Realm with items removed, they can then leave the Succubus Realm as usual. By default items equiped will be destroyed and everything else will be sent to an NPC in the Succubus Realm to be re-purchased with Gold you keep between 'deaths'. What you lose can be configured, and of course disabled completely.

<>- - Advanced Mechanics - -<>

<> Desire <>
Desire automatically generates on the PC overtime and upon Orgasms a large portion will be converted into HeartXP. Optionally Desire can also have negative effects such as draining Max status. [The conversion is a way for players that don't Sex Act a lot as a way to catch up in HeartXP]

<> Tracking <>
While in the Heart Levels menu pressing the 'Reset to Default' key for the MCM Succubus Heart will start tracking that HeartXP cost and display a notification when you've earned enough to level it.